home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / ziplab8.arc / ZIPLAB.DOC < prev   
Encoding:
Text File  |  1991-05-13  |  11.8 KB  |  235 lines
  1.                         
  2.                      ZipLab VIII - ZipLab does Dallas
  3.                    (C)Copyright 1991 by Jeffrey S. Morley
  4.                                May 5th, 1991
  5.  
  6.                    PCBTest.Bat enhancer for PCBoard 14.5
  7.  
  8.                    
  9. ZipLab VIII is a alternative/replacement for the normal PCBTEST.BAT file 
  10. which is run by PCBoard after a user uploads file(s).  In the past, we have 
  11. all run maybe PKUNZIP -T on each file, and if there were no CRC erorrs, all 
  12. was considered well.  There is a lot more we can do to protect ourselves and 
  13. our users from unwanted files!  ZipLab will do the following:
  14.  
  15. * Test for CRC errors in the .ZIP file.
  16. * Test for imbedded .ZIP files and if found, CRC check those too.
  17. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  18. * Virus SCAN imbedded EXE and COM files, using SCAN.EXE from McAffey.
  19. * Remove all .ZIP comments from the file.
  20. * Replace .ZIP comments with your own. (Optional)
  21. * Delete unwanted BBS ads and/or other unwanted ZIP members as you define.
  22. * Reject programs older than a date (year) which you specify.
  23. * Adds most recent .ZIP member date to the description (Optional)
  24.  
  25. * NEW IN THIS VERSION!!! ******************************************************
  26.  
  27. ZipLab VIII   - NO CHANGES TO YOUR .CFG FILE IS REQUIRED FOR THIS RELEASE!
  28.                 Changed the format of the "date" line added to the DIRxx 
  29.                 file description.  Several users requested that both the
  30.                 newest AND the oldest date be indicated.  Done.
  31.                 
  32. ZipLab VII(a) - NO CHANGES TO YOUR .CFG FILE IS REQUIRED FOR THIS RELEASE!
  33.                 Bug fix version only.  There was a problem in the logic with
  34.                 the new internal date verification.  Two things were happening.
  35.                 The first was that any ZIP which contained only one file was
  36.                 failing.  Fixed.  The second was that the OLDEST file in the
  37.                 ZIP was being used for the comparison, not the newest.  Fixed.
  38.  
  39.                 The other addition to this release is the ability to change 
  40.                 the default location that PTEST.EXE uses to unzip files for
  41.                 testing with SCAN.EXE.  PTEST will normally create a directory
  42.                 under your PCB root directory called ..\PTEST.DIR and will 
  43.                 kill this directory when done.  If you wish to have this 
  44.                 work carried on someplace else, set up an environment 
  45.                 variable called ZIPLAB, and put the drive and path there.
  46.                 
  47.                 Example:  ZIPLAB=D:\WORK
  48.                  
  49.                 You may wish this change if your PCB drive is quite small, 
  50.                 or if you wish the work to take place on a virtual disk for
  51.                 speed.  
  52.                 
  53. ZipLab VII    - PTEST.CFG FILE HAS CHANGED!!!  YOU MUST RUN SETUP.EXE AGAIN TO
  54.                 CREATE THE CONFIG FILE.  DON'T FORGET THIS STEP, OR NOTHING   
  55.                 WILL WORK!
  56.              
  57.                 I have eliminated the need for the TESTAGE.EXE program from 
  58.                 the process.  All testing of the dates of the various .ZIP
  59.                 file members is now built into the code.   Boy did I have a 
  60.                 good time figuring out how to turn 5781 into 04/21/1991!
  61.                 
  62.                 As a side-benefit, I now allow you the option of adding a  
  63.                 notation "Date of most recent .ZIP member >> mm/dd/yyyy" to
  64.                 the file description as posted by PCBoard.  This notation
  65.                 will be generated and added by ZipLab if a "Y" is included
  66.                 in the appropriate field in PTEST.CFG.  Place a "N" in this
  67.                 field to bypass this option.
  68.                 
  69.                 Also as a side-benefit, the date of the most recent file will
  70.                 be displayed by ZipLab when a .ZIP passes the age verification,
  71.                 and both the most recent and oldest will be displayed when a
  72.                 .ZIP fails.
  73.                 
  74. ZipLab VI     - No changes to the .CFG file this version.  You need to nothing
  75.                 except replace the PTEST.EXE file.
  76.                 
  77.                 AAARGH!  Missed a hard-coded directory spec I left in the code.
  78.                 (I had put it in during the debug process.).  Unless you were
  79.                 lucky enough to have an "M:\HOLD" directory, all files that 
  80.                 failed the age test were being erased instead of moved.  Fixed.
  81.                 
  82.                 Added the bell (or is it whistle?) of having the first line of
  83.                 the description displayed while the file is testing.  Thanks go
  84.                 to Paul Beda for reminding me that the description is available
  85.                 during the PCBTEST process.  Try his RFUPDESC program to change
  86.                 the column 34-78 descriptions into full line ones.
  87.                 
  88. ZipLab V      - PTEST.CFG FILE HAS CHANGED!!!  YOU MUST RUN SETUP.EXE AGAIN TO
  89.                 CREATE THE CONFIG FILE.  DON'T FORGET THIS STEP, OR NOTHING 
  90.                 WILL WORK!
  91.                 
  92.                 This version now supports users in NON-COLOR mode.  ZipLab will
  93.                 detect these users, and will not display any colors.  The user
  94.                 MUST STILL HAVE ANSI.SYS LOADED!  ANSI codes are used for moving
  95.                 the cursor.  If you have lots of users calling in with non-DOS
  96.                 machines which can't support ANSI, don't use ZipLab.
  97.                 
  98.                 Somewhat against my better judgement, you may now ADD a zip
  99.                 comment to the file while testing.  There is an additional 
  100.                 line added to PTEST.CFG.  If you can resist the urge to mess
  101.                 with the .ZIP, please put "NONE" in this field.
  102.                 
  103.                 Fixed some problems with TestAge, including a bad compile which
  104.                 was mistakenly sent out in some ZipLab IV packages.  
  105.                 
  106.                 Added the /NOMEM command to the call to SCAN.EXE, so your local
  107.                 RAM memory won't be tested every time.  This will speed things
  108.                 up quite a bit.
  109.                 
  110. ZipLab IV     - This version of ZipLab is now an EXE file, instead of a series 
  111.                 of batch commands.  This was done to speed the process up.  The 
  112.                 batch file method, while effective and flexible, was very slow.  
  113.                 Many users were becoming discouraged waiting on large, 
  114.                 multi-file uploads to be tested. 
  115. *******************************************************************************
  116.  
  117. REQUIRED:
  118. You must already have the following programs:
  119.  
  120. PKZIP.EXE - Phil Katz archive create program (version 1.01)
  121. PKUNZIP.EXE - Phil Katz archive extract program (version 1.01)
  122. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
  123. SCAN.EXE - McAffey's virus detection program (any version)
  124.  
  125. There are other small utility programs which I have bundled with this .ZIP.
  126. Those which were not written by me may require registration for continued
  127. use.  PLEASE SUPPORT SHAREWARE AND DO SO!
  128.  
  129. RECOM.EXE - Mike Loewen's ZIP file comment remover and date stamper.
  130.  
  131.  
  132. Quick Start ---
  133.  
  134. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is limited
  135.   memory available for PTEST.EXE.  If you are running in a multitasking 
  136.   or other memory constrained situation, PTEST may not work!  You should 
  137.   have at least 210k free memory when shelled out of PCBoard.  If this is
  138.   a problem, you may want to consider the VAROOM (overlay) version of 
  139.   PCBoard, which runs in considerably less memory than the standard PCB.EXE.
  140.   
  141.   The other option is to run PCBoard with the SET PCB = /SWAP environment
  142.   variable.  This will cause PCBoard to "swap" its code to the best available
  143.   storage (EMS, DISK) whenever a SHELL function (external protocol, viewfile,
  144.   and even DOORs if you have the SHELL column in DOORS.DAT(LST) set to "Y")
  145.   is called.  This method will cause a slight delay when SHELLing, but will
  146.   provide the largest amount of available DOS memory for your external code.
  147.   
  148. * Place the PTEST.EXE and SETUP.EXE files into a directory which is in your
  149.   DOS PATH.
  150. * UnZIP the enclosed supplemental utilities into directories in your DOS PATH.
  151.   Make note of where you put them, you will need this information later.
  152. * Change to your PCBoard HOME directory (C:\PCB for many) and run SETUP.EXE.
  153.   The resulting PTEST.CFG must reside in your PCBoard home directory.
  154. * Fill in the following information when prompted by SETUP.EXE:
  155.  
  156.         -  The type of modem HANDSHAKE you desire.  This can be 
  157.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  158.            (Use 2 or 3 with an error correcting modem...)
  159.         -  The name of your BBS system.  43 characters maximum.
  160.         -  The DRIVE and PATH to the directory where rejects will be
  161.            placed pending manual sysop inspection.
  162.         -  The date (yyyy) which will be the minimum acepted year.  ZIPs
  163.            containing files older than this will be rejected.
  164. NEW!!!  -  A "Y" if you wish the "recent date" notation added to the file
  165.            descriptions.  A "N" if you do not wish this addition.
  166.         -  The fully qualified filename of the zip comment to add, or
  167.            type "NONE" if you don't want to add a comment.
  168.         -  Full DRIVE:\PATH to PKZIP.EXE.
  169.         -  Full DRIVE:\PATH to PKUNZIP.EXE.    
  170.         -  Full DRIVE:\PATH to TDCHECK.EXE.
  171.         -  Full DRIVE:\PATH to SCAN.EXE.
  172.         -  Full DRIVE:\PATH to RECOM.EXE.
  173.            (I need these spelled out becuase the method I am using 
  174.             to get ERRORLEVELS returned to the program requires it.)
  175.         -  A list, each on one line, of any extensions (.GIF, .TXT etc)
  176.            Which will be passed without normal ZIP testing.  Any 
  177.            extensions other than .ZIP which do not appear in this .CFG
  178.            file will be rejected by the process.  The "." is optional.
  179.         -  A list, each on one line, of files which you wish deleted
  180.            from .ZIP's before posting.  This could include the famous
  181.            "READMEOR.DIE", "BBS.AD", or other unwanted advertising.
  182.  
  183.             Sample PTEST.CFG file:
  184.             
  185.             2           
  186.             The Interconnect BBS
  187.             M:\HOLD
  188.             1990
  189. NEW!!!      Y
  190.             C:\EXE\COMMENT.CMT
  191.             C:\ZIP\PKZIP.EXE
  192.             C:\ZIP\PKUNZIP.EXE
  193.             C:\ZIP\TDCHECK.EXE
  194.             C:\DIAGS\SCAN.EXE
  195.             C:\EXE\RECOM.EXE
  196. NEW!!!      There used to be a line for TESTAGE.EXE here, delete the line!
  197.             .ROM
  198.             .GIF
  199.             ANNOYING.BBS
  200.             README.TOO
  201.  
  202. * Edit your existing PCBTEST.BAT file, and delete the whole thing except
  203.   for two lines:
  204.   
  205.   Sample PCBTEST.BAT file:
  206.   
  207.   @ECHO OFF
  208.   PTEST %1
  209.    
  210. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass 
  211.   command over to PTEST.EXE with the parameter containing the path
  212.   and name of the file to be tested.  PTEST will check out the file,
  213.   placing any rejects in the holding directory you specified in the
  214.   SETUP process above.  
  215.  
  216.  
  217.   
  218. This program was written in QuickBasic 4.5, with some help from Hammerly 
  219. Computing's ProBas 4.01.  I have also included a few utilities which PTEST 
  220. will use in the course of testing.  These utilities are the property of the 
  221. authors, and you are strongly requested to register them if you continue to 
  222. use PTEST.EXE.  There is no registration required for PTEST itself, nor for 
  223. any of the little utilities included which were written by me.
  224.  
  225.  
  226. Jeffrey S. Morley
  227. The Interconnect BBS
  228. (703)425-2505
  229.  
  230. * PTEST.EXE, SETUP.EXE, and DELF.COM are my own creations, and no
  231.   registration is required.  They are all:
  232.   (C)Copyright 1989-1991 by Jeffrey S. Morley
  233.   
  234.  
  235.